home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Utilities / Installers / InstallerMaker™ 3.0 / Preinstalled version / Customizing InstallerMaker / Editing Resources / Editing Installer Resources < prev    next >
Encoding:
Text File  |  1996-04-21  |  3.9 KB  |  94 lines  |  [TEXT/R*ch]
  1. How to Edit Your Installer's Resources
  2. © Copyright 1995 Aladdin Systems, Inc.
  3. -------------------------------------
  4.  
  5. All of the user interface elements your users see when they run an 
  6. InstallerMaker product installer can be changed if you need to do
  7. so. Many of these items can be changed directly from within the
  8. InstallerMaker application you use to configure your product
  9. installers.
  10.  
  11. Occasionally, you will not see the string you want to change, or
  12. you will need to change the size of a dialog, or the location of
  13. items within a dialog.  These can also be changed, through the
  14. use of a resource editing application like ResEdit (available
  15. from Apple) or Resorcerer (from Mathemaesthetics, Inc.).  This document
  16. describes how to use a resource editor to change the user 
  17. interface elements you want to change.
  18.  
  19. For the rest of this document, we assume that you own a resource 
  20. editor, and that you know how to use it.  If the topic of
  21. resource editing on a Macintosh is new to you, we recommend 
  22. "Zen and The Art of Resource Editing", a book available from the
  23. Berkeley Macintosh Users Group (BMUG).  You can reach BMUG by
  24. telephone at 510-549-2684, or via the Web at www.bmug.org. The
  25. old style address is:
  26.  
  27.  BMUG Inc. 
  28.  1442A Walnut Street, #62 
  29.  Berkeley, CA 94709-1496
  30.  
  31.  
  32. How To Edit a Resource In Your Installer
  33. ----------------------------------------
  34.  
  35. Since our installers use resource compression, most resources in
  36. your product installer are compressed, and can not be edited 
  37. directly. To find an uncompressed copy of an installer's resources,
  38. you should locate the file "Installer Resources" located in the 
  39. "Editing Resources" folder in the "Customizing InstallerMaker" 
  40. folder found in the same folder as the InstallerMaker 3.0
  41. application.  The steps to change a resource are:
  42.  
  43. 1) Open the "Installer Resources" file in your resource editor 
  44. and locate the resources that you want to change.
  45.  
  46. 2) Create a new resource file in your resource editor, and copy
  47. _only_ the resources you want to change into the new resource
  48. file.
  49.  
  50. 3) Use your resource editor to modify your resources, and save the
  51. changes.
  52.  
  53. 4) Open your installer archive up in InstallerMaker 3.0, and note the
  54. icon on the lower left of the window.  This is a button used to link
  55. an "included resources" file to your archive.  If it says "No resource
  56. file included", then you are not currently including a resource file.
  57. If this is the case, click on the icon, and select your resource file
  58. you created in step (2) in the file selection dialog that comes up.
  59.  
  60. If you've already selected some other file, perhaps because you've
  61. included InstallerMaker extensions into your installer, you'll need
  62. to copy the resources in your new file into the file that contains your
  63. custom resources.  The procedure is the same as the one you used in
  64. step (2).
  65.  
  66. 5) Build your installer as usual.  InstallerMaker will build your
  67. modified resources into your product installer, giving you the affect
  68. you wanted.
  69.  
  70.  
  71. Warnings About Changing Resources
  72. ---------------------------------
  73.  
  74. Remember that when you change a resource your product installer uses,
  75. you are changing the data the product installer uses to display information
  76. to your users.  As a rule of thumb, changing the wording of any item is
  77. perfectly safe, and changing one picture with a different picture will
  78. also be safe.  In addition, changing the size of a DLOG or ALRT resource
  79. is OK, as is changing the position of an item in a dialog list resource
  80. (DITL).
  81.  
  82. Two things, however, are not safe.  You should never delete an item
  83. in a DITL, nor should you insert new items into a DITL in such a way that
  84. the item numbers of standard items change.  Doing this will cause your
  85. installers to behave strangely, or even crash. 
  86.  
  87.  
  88. Changing the Progress Dialog
  89. -----------------------------
  90.  
  91. You can also modify the progress dialog that comes up during the unstuffing
  92. process. If you need to do this, read the document "Customizing Progress Bars"
  93. in the same folder as this document.
  94.